SetAxisPositionOffset

使用相同值操控軸的設定點位置和實際位置來移動軸的坐標系統，而不會導致任何移動（使用相同的跟隨誤差重新校正），此可在參考情況用作實例。

語法

KsCommandStatus SetAxisPositionOffset(
     int Index,
     double Position,
     BOOL Relative,
     McExecutionMode ExecutionMode
);

參數

Index [in]：軸索引。索引以零為起點；別名將影響此參數。

Position [in]：位置單位（若 Relative 為 TRUE 則為距離單位）。

Relative [in]：若為相對距離，設 TRUE；若為絕對距離設 FALSE，預設為 FALSE。

ExecutionMode [in]：定義函式的時間順序，請見 McExecutionMode 類型。

回傳值

返回 KsCommandStatus 結構。

備註

此函式僅適用於停止(Standstill) 或停用 (Disabled) 狀態。
Relative 表示在執行時加入 Position（距離單位）至軸的實際位置，目標位置的結果將為實際位置＋距離，例如，實際位置為 50、距離為 100，則目標位置將為 150；"Absolute" 表示軸的實際位置為 Position 參數內指定的值。
當模數軸啟用時，Absolute 模式的輸入值將被轉換為模數位置；而 Relative 模式的輸入值則被用作距離，而非模數位置。

範例

複製

KsCommandStatus offsetCommand = WaitForCommand(10, TRUE,
   SetAxisPositionOffset(0, 0, FALSE, McExecutionMode::mcQueued));

使用需求

參見